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NOTE: Custom ammo **requires** Otherloader! 
(https://github.com/devyndamonster/OtherLoader) 

When you build your mod, build to (H3VR/Deli/Mods/legacy/LegacyVirtualObjects), but 
make sure to pack it as a Deli file for release! Alternate building method included below. 


Step 1 - Setup 


You'll need a few things before you can get started. 


First, go ahead and make a new unity project that you would use for implementing a gun 
(so you have all of the scripts). You can get phoenix’s template here, just open it with unity. 
It's up to you what you name it, but | recommend targeting your Deli>Mods folder for ease 
of testing. 


In the example below, | made a folder inside of my Deli>Mods folder that acts like a Deli 
file. 


Local Disk (C:) Program Files (x86) Steam steamapps common H3VR Deli Mods AmmoStuffs 


Name Date modified Type Size 


| build 2021-04-21 10:59 AM File folder 
B grammo 04-21 10:59 AM File 


B manifest.json 2021-04-17 11:26 AM JSON Source File 


“grammo” is the name of my asset bundle, and | build into the “build” folder. After | build 
from unity, | drag and drop the file one level up and replace the old assetbundle, then 
delete all extra files that are still inside the “build” folder. Here is an example of it's 
manifest: 


"guid": "h3vr.ammo.grammo", 
"version": "1.2.0", 
"require": "0.3.1", 
"dependencies": { 
"h3vr.otherloader.deli": "0.1.0" 

a 
"name": "grammo", 
"description": "No capitals please", 
"authors": [ 

"gamernayr" 
], 
"assets": { 

"runtime": { 


"grammo": "h3vr.otherloader.deli:item" 


Everything in there should be self explanatory. Make sure to use your own unique guid field 
as Deli will stop loading if there is a conflict. As you can see from the manifest, we require 
OtherLoader. Head on over to the github page and download the latest .deli file. Make sure 
to install it by dragging it into your Deli>Mods folder. 


Next, open your scripts folder. 


Assets > Scripts » Assembly-CSharp Fist VR 


Place theses two files into it: 


Display Data 
BallisticProjectile 


Make sure to override your old files. 


Step 2 - DD Setup 


You now have the required tools to make custom ammo, so lets make something simple. 


First, make a DisplayData file by right clicking in your assets tray: 


Alloy Packed Map Definition 


Show in Explorer 
Open 

Delete 
Open Scene Additive 


Import New Asset... 
Import Package > Javascript 

Export Package... Shader > 
Find References In Scene 
Select Dependencies 


Refresh 
Reimport 


Reimport All 


Run AP! Updater... Lens Flare 


Render Texture 


— Open C# Project 

easter Porameters 
el 

If this option doesn’t show up, it means you didn't import the scripts correctly. 

It will look like this: 


v inspecur | Service a v= 


New Definition *, 


Script FVRFireArmRoundDisplayData (0) 

Display Name (a 

Type | A22_LR a 

Round Power | None $1 
Vv Classes 


Size 0 
Is Meat Fortress LJ 
BDCC 
Zero Which Ammo 
Zeroing Vel 
Zeroing Mass 
Zeroing X Dim 


eT] 
0 
0 
0 
ee 
Bullet Drop Curve —_—_— 
| 


Vel Mult By Barrel Length Curve 


The display name will only matter if you are creating a custom ammo type, such as .357 
imaginary or something not yet in H3VR. 


To create anew ammo type, search “roundtype” in the asset window: 


© round type 
Search: ‘AmmoStuffs' Asset Store: 2/ 26 


C# 


FireArmRou... 


Open this file and add your own entry to it. Note: If your entry number is the same as 
another mod, they will conflict. Here is an example using Gyurza ammo. 


Now it will show up in the “Type” dropdown menu. 


ACpbp 

A50mm Potato 

AHCEB Bolt 

A Flame Thrower Fuel 
A50_Imaginary 
A45_Colt Oversize 

A 9x21 Gyurza GMR 


The ammo will be imported into the game this way using the assetbundle, and will be 
sorted correctly if both the round type and power match it’s vanilla counterpart. 


Try increasing the “classes” variable to 1: 


This is where the DD file will see our custom ammo. See the “class” dropdown under 
“Element 0”? That is what the game will call when it tries to spawn our ammo. 


Very important: 
Do not have your custom ammo the same class as a vanilla one. 


9x19mm>FM] exists, so don’t use it. 
9x19>Cannonball doesn't, so you can use it. 
9x21 Gyurza has no other competition, so it can use any class it wants. 


If you want to create your own class for your ammo (usually a good idea), then search 
“roundclass” in your assets window: 


‘AmmoStuffs' Asset Store: 0/0 


In this file, add your own class entry. Here is an example of my class setup so far: 
al2gBirdshot = 203, 


aDualSabot = 210, 
a5@BMG = 211, 
85Magnum = 212, 


a1143x23AP = 215, 


The same problem arises here as with round type, do not use one that is already in use, 
and mods can conflict if they use the same ones. Choose something unique. 


Next, we will work on the bullet curves. 
Download this zip file 


Next, click on an empty curve box inside of your DD file (any of the 3). 


BDCC 

Zero Which Ammo 

Zeroing Vel 

Zeroing Mass 

Zeroing X Dim 

Bullet Drop Curve 

Vel Mult By Barrel Length Curve 


Grid 
Y list 
‘Y Default 
Create New Library... 


BDCC Add Factory Presets To Current Library 


Bullet drop 


Vel mult harrel 


Extract the “DefaultCurves.zip” file here, replacing any files it needs to. 


You should now have labeled curves to use with your DD file, plop them in. 


BDcc i 
Zero Which Ammo OOO 
Zeroing Vel 600 

Zeroing Mass 0005 © 0) 
Zeroing X Dim [0.013 tti“( (‘COO 
Bullet Drop Curve ey 
Vel Mult By Barrel Length Curve | 


The values in the middle are for sight zeroing, and we will get to those in a second. 


Step 3 - Prefab Importing 


If you have done prefab importing for firearms or attachments before, this should come as to no 
surprise what we are doing. 


Open your H3VR directory: 


© Hot Dogs, Horseshoes & Hand Gre 
&® Job Simulator » PLAY 
Pistol Whip 


ta Tabletop Simt 


, : ; TurnSignal 


VR Dungeon f Manage 


Browse local files 


Navigate to this folder and copy this file into your unity project: 


Local Disk (C:) Program Files (x86) Steam steamapps common VR h3vr_Data StreamingAssets 


Name late modified lype 


MANIFEST File 


File 
2021-04-03 9:37 AM MANIFEST File 3 KB 


2021-04-03 9:36 AM 


File 155,374 KB 


4 


Create an empty GameObject 
File Edit Assets GameObject C 


i + Ls 
= Hierarchy 


Create *| (QrAll 


Create Empty Child 


Add the PrefabLoader script to it 

@ Inspector | Services Sie 
\4 GameObject (_] Static v 
Tag | Untagged +) Layer | Interactable y 
VA Transform % 

Position x0 Yo Z\0 

Rotation X/0 Y\o Z0 

Scale X\1 Yji = fl 
VG) 4 Prefab Loader (Script) %, 
Script PrefabLoader fo) 
Prefab Path Assets/AmmoStuffs/assets_resources_objectids_weaponry_amn 
Prefab_to_Load Assets/Weaponry/_Ammunition/Prefabs/40mmCaseless/Ammo_ 


Add Component 


In the “Prefab_Path” area, put the location of the file we just copied. 


In the “Prefab_to_Load” area, you'll want to put the prefab of the ammo you want to replicate. 
Open this file in your notepad of choice (I use VSCode). 


Local Disk (C:) Program Files (x86) Steam steamapps common H3VR h3vr_Data StreamingAssets 


Name Date modified Type 


3 assets_resources_objectids_sosig.manifest 2021-0 AM MANIFEST File 


‘il assets_resources_objectids_toytargetstools 20 4-03 9:36 AM File 
MANIFEST File 
veaponry_ammunition 20 M File 


g assets_resources_objectids weaponry_ammunition.manifest 2021-04-03 9:38 AM MANIFEST File 


scets S ces 5 we 


Copy the prefab path you want 


Assets/Weaponry/_Ammunition/Prefabs/762x25mm/Ammo_762x25mm_FMJ.prefab 


s/Weaponry/_Ammunition/Prefabs/2@guage/Ammo_2@gauge Freedomfetti.prefab 


/_Ammunition/Prefabs/455Webley/Ammo_455Webley Tracer.prefab 


/_Ammunition/Prefabs/Cpbp/Ammo_aCpbp. prefab 
_Ammunition/Prefabs/S@Imaginary/Ammo S@Imaginary_BOOOMY.prefab 
Assets/Weaponry/_Ammunition/Prefabs/408Cheyenne/Ammo_4@8Cheyenne_AP. prefab 


Add it to “Prefab_to_ Load”. 


See these buttons? 


Press “pause”, then press “play”, and wait for them to turn blue. 
On the left, you should see your ammo is in your hierarchy. 


There is the ammo we had highlighted last step. 


Go ahead and drag that into your assets window and press “play” again. 
Now you should have this little guy in your box. 


Ammo_762.. 


Rename it to whatever you want. Call him Doolie. 
Drag Doolie back into your hierarchy and expand him. 


Highlight Doolie’s main prefab (his name), and press the apply button on the right window. 


7 L Static ¥ 
Tag Layer 
Prefab 


Every time you make a change to Doolie, you will have to do this. Do this often, and don’t forget 
to save! 


Step 4 - Material Setup 


Now that our pal Doolie is ready, we need to give him some skin. Due to how bullets are 
rendered, they can’t be transformed inside of a magazine or chamber. So first we need to make 
sure the bullet is perfect before we continue. 


Open Blender (or whatever) and import your bullet model into it. Here is an example of a 
shotgun shell: 


Open a model from H3VR as well, something similar. You'll notice something odd, they don’t 
look the same do they? 


In general, H3 makes the default origin of their points wherever they are in the mag. If you are 
creating a custom magazine just for this ammo, you can do whatever you want with it, just know 
that it may cause more hassle in the long run. 


Line your model up and export it. 


Blender has a useful “Selection Only” mode when exporting, | suggest you use that. 


Operator Presets 


¥ Include 
Limitto ™ Selection Only 


Objects as 1 OBJ Objects 
OB] Groups 


As with other textures in H3, everything uses Alloy. 
Make your material from the assets window and set it to Alloy>Core. 


Show in Explorer FVRObject > 
Open ltemSpawner > 
Delete Alloy Packed Map Definition 
Open Scene Additive Folder 
Import New Asset... C# Script 
Import Package > Javascript 
Export Package... Shader > 
Find References In Scene Testing > 
Select Dependencies Sous 
Refresh Ctrl+R Prefab 
——— Audio Mixer 
snc Material 
Run API Updater... Lens Flare 
lcd Open C# Project Render Texture 
Lightmap Parameters 
.aTnkt... . 
SOBMG 
Shader | Alloy/Core 
Standard 

Rendering Mo Standard ( eee 

Normals Sour — ps 

Roughness Sc Alloy Mods > Bp Alpha 

Tint FX > 

GUI > Decal > 


» Base Color 
Fill in the 3 fields. If you need to pack your texture sets, use this window: 


ee reer J es ye ee eee eee ree mere 


ment Window Help 


ot | € Next Window Ctrl+Tab 
Previous Window Ctrl+Shift+ Tab 
ee Alloy > Material Map Channel Packer 


Material Map 


Packed Terrain 


Ly Please select a texture or a value. 


Auto Regenerate 
Regenerate this map when any of its input textures are updated./ 


AmmoStuffs/Models/Materials’ SOBMG = | _AlloyPM.png 


The material fields are as such: 
- Base color/Diffuse 
- Alloy/gloss 
- Normal 


Unity PM 


| Black | 
| Gray | 
[white | 
[Custom | 
Black | 
| Gray | 
L_white | 
_Custom | 
[Black | 


| white | 
| Custom | 


| Black | 
| Gray | 
|_white | 
| Custom | 


© Inspector = 
@& 508MG @ #, 


Shader 


Fill out Doolie’s meshes: 


These should already be filled, but just in case: 


Step 5 - Ballistics 


Create an empty game object. 


eS ie — 
} or All Oe naam 


Create Empty 


Pueede Posed. CL 


Add the Ballistic Project script. 


\¥ 12g50BMG_Ba (_) Static v 
Tag (Untagged 0) Layer [Interactable 0 


« BallisticProjectile 
0.005 


Save the object by dragging it into your assets window, you can delete it now from the hierarchy. 


Everything in here will be unique to your round, and will require some work to test and make 
perfect on your end. 


| highly suggest running your scene again (pause/play) so your clone appears. Once it does, 
click on it and scroll down on the right window 9the one with all the options). You should see two 
fields that are the same under Ballistic Projectile Prefab. 


Double click on this, and it should come up with a hidden object: 


These are the values the bullet you pulled uses, so take a picture (Win+Shift+S) and press play 
again. 

Open your empty game object that we added the ballistic projectile prefab to and copy those 
values in. 


From my testing, here are what the values mean: 


Mass in kg (0.005 is 5g) 
X,Y should be the same, diameter of the bullet, Z is length 


How big the tip of the head is 
May/may not effect anything, just set it up as you would think 


Enables incendiary ammo effect 


Ignition chance Chance to fire, | think it works off of a *100% scale (0.2 is 20%) 


KE Total For Hit Blunt damage/how much damage the sosig takes from a direct 
impact 


KE Per Square Meter Piercing damage, this one is weird | have no idea what it does 
Base really, scales off of X/Y 


Flight velocity mult Dunno if this is over time or something else 
Air drag How much velocity the bullet loses as it travels 
Gravity How much it drops 

Disabled on first impact | Ricochets 

Generates impact sound | Self explanatory 


Impact sound type Self explanatory 


Generates impact details | Self explanatory 


Impact FX magnitude How big impact details are 


Generates suppression Gets suppressed 
event 


Suppression intensity How much sound the gun is reduced when it is shot 


Range How far a bullet will travel in meters before it just decides to off 
itself 


Deletes on straight down | If a bullet is travelling at a 90 degree angle it dies 
Source_|IFF Dunno 

Uses IFF Mat Swap Dunno, leave off 

Max Range How far it will render before the bullet despawns 
Max range random Can random that above var 

Die timer max Max X seconds alive 


Tracer All tracer stuff is still under investigation, let us know if you figure it 
out 


Submunitions Used for explosives/things to create when the bullet dies 


Once it’s filled out, open Doolie and place his shiny new ballistic data game object into where 
you saw your cloned prefabs sitting. 


Ballistic Projectile Prefab 


Step 6 - Housekeeping 


You see the Round Type and Round class in that above picture? Fill those out how you set them 
up earlier (in step 2). 


Create an object ID. 


Alloy Packed Map Definition 
Folder 


Run API Updater... 


Open C# Project 


Render Texture 
Lightmap Parameters 


Here is an example of a filled out one. 


Make sure the Asset Name field points to Doolie, and give him a codename in each of those 
fields. 


Credit Cost U 
O Sple iv 
Make sure O Sple is checked. 


Go back to your DD file, and add doolie to your classes and fill out the rest of your data. 


New Definition i) +, 


| Open | 
Script FVRFireArmRoundDisplayData 10) 
Display Name (Doolieisspecial 8 | 
Type | A12g_Shotgun +] 
Round Power | Shotgun 2] 
¥ Classes 
Size il 
Vv Doolie :) 
Name Doolie :) 
Class | ASOBMG 2] 
Object ID ~ 12g50BMG_ID (FVRObject) ° 
Is Meat Fortress - 
BDCC ey er 
Zero Which Ammo 0 
Zeroing Vel 0 
Zeroing Mass 0 
Zeroing X Dim re 
Bullet Drop Curve ee | 
Vel Mult By Barrel Length Curve _ 


“Doolie :)” is what will show up on the ammo panel. 


Don't forget to fill your object wrapper! 


Use Second Step Kotation riltering LJ 
Object Wrapper 12g50BMG_ID (FVRObject) 
Snawn | ockahble 


Create your assetbundle name, and add your Prefab, Objectld, Ballistic Profile, and DataDisplay 
to it. Make sure to target your build folder. 
We only need this one file (yours will be named whatever you called it): 


Local Disk (C:) Program Files (x86) Steam steamapps common H3VR Deli Mods AmmoStuffs build 


Name Date modified Type 


B build 2021-04-21 8:11 PM File 


B build.manifest MANIFEST File 

B frammo 0 : File 

= frammo.manifest -21 8:11 PM MANIFEST File 

Bi grammo 2021-04-21 8:11 PM File 2,474 KB 
B grammo.manifest 2021-04-21 8:11 PM MANIFEST File 5 KB 


Delete the others, then move it into the folder one up. 


» build 


AmmoStuffs 


Should look like this 


Local Disk (C:) Program Files (x86) Steam steamapps common H3VR Mods 


Name Date modified Type Size 


Bm build 2021-04-21 8:13 PM File folder 
B grammo 2021-0 V File 


o manifest.json 29 PN JSON Source File 


Deli will see the folder has a manifest file and treat it like a Deli file. 


To make it a Deli file, simply zip it. 
gra 10171 MA 710.11 DAA File 


BE °O Open with Code | __ JSON Source File 


== Send with Transfer... 


Scan with Microsoft Defender... 
Share 

Add to archive... 

Add to "AmmoStuffs.rar" 
Compress and email... 


Compress to "AmmoStuffs.rar" and email 


[HRS 


Scan with Malwarebytes 


Send to > | & Bluetooth device 


AmmoStuffs 


Cut | E Compressed (zipped) folder 


Rename it to a deli 


E 2021-04-21 8:14 PM Compressed (zipp... 


2,475 KB 


